
                  SONIC ADVANCE INTERNATIONAL

              Game Source Code for Sketchware Pro

╔=====================================╗       ▓        ▓        
║ Table of Content                    ║      ▓▒▓      ▓▓▓       
╠=====================================╣     ▓▓░▓▓ ▓ ▓███▓░      
║ 1. Extract/Create .swb file         ║    ▓▓▒░░▓▓▓▓▓▓▓▓██      
║ 2. Game content                     ║   ▓▓▓▒░░▓▓█▓▓▓█▓▓▓█     
║   A. Basics                         ║   ▓▓▓▓▓▓▓▓▓█▓▓▓█▓▓▓█    
║   B. "data" folder                  ║   ▓▓▓▓▓▓▓▓▓▓██▓█▓█▓█    
║ 3. Using Sketchware Pro             ║    ▓▓▓▓▓▓▓███▓█▓█▓█▓    
║   A. Build/Install game application ║ ▓▓▒▒▒▓▓▓▓▓▓▓▓▓▓████▓▒   
║   B. Find the .apk file             ║ ▓▓▓▓▓▒▒▒▒▒██ ▒▒▒▒▒█ ▒   
║   C. Programming in Java            ║  ▓▓▓▓▓▒        ▓▓▓▓▓▓   
╚=====================================╝  ▓▓▓▓▓▒   ▓▓      ▓███  
                                          ▓▓▓▓▓▒    ▓▓▓       ░ 
  Furrican 1:37 PM                        ▓▓▓▓▓▒       ▓▓▓▓▓▓▓░ 
  Screw the new Android policy!            ▓▓▓▓▓▒░░    ░░░░░░░  
                                           ▓▓▓▓▓▒░░░░░░░░       
╔==============================================================╗
║ 1. Extract/Create .swb file                                  ║
╠==============================================================╣
║ You can extract a .swb file either by using an extractor     ║
║ program like 7-Zip, or by converting the .swb file into a    ║
║ .zip file.                                                   ║
║                                                              ║
║ You can also create a .swb file by converting a .zip file    ║
║ into a .swb file. Make sure to select the "data" folder,     ║
║ "resources" folder and the "project" file to compress them   ║
║ in the .zip file.                                            ║
╚==============================================================╝
╔==============================================================╗
║ 2. Game content                                              ║
╠==============================================================╣
║ 2A. Basics                                                   ║
║ ----------                                                   ║
║ Inside the .swb file are different folders and content.      ║
║                                                              ║
║ The "data" folder is where the game content is located, and  ║
║ the "resources" folder contains regular Sketchware content.  ║
║ The only thing relevant in this folder is the app icon, as   ║
║ Sketchware Pro is not capable of using mipmap icons.         ║
╠==============================================================╣
║ 2B. "data" folder                                            ║
║ -----------------                                            ║
║ In the "data" folder is 2 folders and files related to       ║
║ Sketchware Pro's functionalities.                            ║
║                                                              ║
║ The "files" folder contains the game assets, Java code, app  ║
║ name and mipmap icons, whereas the "Injection" folder        ║
║ contains files related to the AndroidManifest.               ║
╚==============================================================╝
╔==============================================================╗
║ 3. Using Sketchware Pro                                      ║
╠==============================================================╣
║ 3A. Build/Install game application                           ║
║ ----------------------------------                           ║
║ After creating your .swb file, you can build the game        ║
║ application by using Sketchware Pro.                         ║
║                                                              ║
║ In Sketchware Pro, select "Restore projects" and find your   ║
║ .swb file you have created. Then, open the project and       ║
║ select "Run" to build and install the game application.      ║
╠==============================================================╣
║ 3B. Find the .apk file                                       ║
║ ----------------------                                       ║
║ After building the game application, you can find the .apk   ║
║ file of the game. however, it is located inside a hidden     ║
║ folder of the Android internal storage.                      ║
║                                                              ║
║ You need an application like ZArchiver to access hidden      ║
║ folders.                                                     ║
║ The .apk file is located in ".sketchware/mysc/XXX/bin".      ║
║ Once you found the right location, you can see the .apk file ║
║ named "NewProjectXX".                                        ║
╠==============================================================╣
║ 3C. Programming in Java                                      ║
║ -----------------------                                      ║
║ The benefit of using Sketchware Pro is the ability to        ║
║ build Android applications by using Java code, making game   ║
║ development easier than programming in bytecode.             ║
║                                                              ║
║ You can either use a programming tool to change the Java     ║
║ code in the "java" folder, or after restoring the project,   ║
║ you can check the Java code via the "Java/Kotlin" menu.      ║
║                                                              ║
║ Make sure the game code is well structured. Otherwise,       ║
║ Sketchware Pro will showcase error messages when building    ║
║ the application.                                             ║
╚==============================================================╝
